Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / PostScript Imaging Messages

GXPostScriptDoDocumentSetup

QuickDraw GX sends the GXPostScriptDoDocumentSetup message to set up document-level formatting information. You can override the GXPostScriptDoDocumentSetup message to issue any code that is required for the imaging of the whole document. Your override of the GXPostScriptDoDocumentSetup message must match the following formal declaration:

OSErr MyPostScriptDoDocumentSetup (
                        gxPostScriptImageDataHandle hImageData);

hImageData

A handle to the PostScript imaging system structure.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the GXPostScriptDoDocumentSetup message in its default implementation of the GXImageDocument message, prior to imaging the first page of the document. You can override this message to issue any PostScript instructions that apply to the document; for example, to set up the default halftone accuracy.

The default implementation of this message changes the display in the desktop printer window to reflect the current document and user names.

SPECIAL CONSIDERATIONS

You always forward the GXPostScriptDoDocumentSetup message to allow other message handlers the opportunity to perform document-setup tasks. Forward this message and then add your own operations.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

The default implementation of the GXPostScriptDoDocumentSetup message can also return the communications errors that are listed in Table 4-2 on page 4-42.

SEE ALSO

The PostScript imaging system structure is described on page 4-26.

The GXImageDocument message is described on page 4-93.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help